MediaGetSrcRgn(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / Graphics Data Management

MediaGetSrcRgn
The MediaGetSrcRgn function allows your derived media handler to specify an irregular destination display region to the Movie Toolbox.
pascal ComponentResult MediaGetSrcRgn (ComponentInstance ci,
                                       RgnHandle rgn, 
                                       TimeValue atMediaTime);
ci
Identifies the Movie Toolbox's connection to your derived media handler.
rgn
Contains a handle to a region. When the Movie Toolbox calls your function, this region is initialized to the track's boundary rectangle (which is defined by the width and height fields in the movie parameter structure that you obtain when the toolbox calls your MediaInitialize function, which is described on page 10-17). Your media handler may then alter this region as appropriate, so that it corresponds to the boundaries of your media's display image. Note that this region is in the track's coordinate system, not the movie's.

Do not dispose of this region--it is owned by the Movie Toolbox.
atMediaTime
Specifies the time value at which the Movie Toolbox wants to know what the source region is.

DESCRIPTION
The Movie Toolbox uses this function to determine whether your media has an irregularly shaped display area. If your media is displayed in a nonrectangular area, or if your media uses only a portion of the track rectangle, you can use this function to report that fact to the toolbox.
Your derived media handler should support this function if your media does not completely fill the track rectangle during playback.
The Movie Toolbox calls this function only if you have set the handlerHasSpatial flag to 1 in the flags parameter of the MediaSetHandlerCapabilities function.

RESULT CODES
Any Component Manager result code